home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / prog_pas / tsfaqp31.zip / FAQPAS2.TXT < prev    next >
Text File  |  1996-04-28  |  46KB  |  1,113 lines
  1. From ts@uwasa.fi Sun Apr 28 00:00:00 1996
  2. Subject: FAQPAS2.TXT contents
  3.  
  4.                              Copyright (c) 1993-1996 by Timo Salmi
  5.                                                All rights reserved
  6.  
  7. FAQPAS2.TXT More frequently (and not so frequently) asked Turbo
  8. Pascal questions with Timo's answers. The items are in no particular
  9. order.
  10.  
  11. You are free to quote brief passages from this file provided you
  12. clearly indicate the source with a proper acknowledgment.
  13.  
  14. Comments and corrections are solicited. But if you wish to have
  15. individual Turbo Pascal consultation, please post your questions to
  16. a suitable Usenet newsgroup like news:comp.lang.pascal.borland. It
  17. is much more efficient than asking me by email. I'd like to help,
  18. but I am very pressed for time. I prefer to pick the questions I
  19. answer from the Usenet news. Thus I can answer publicly at one go if
  20. I happen to have an answer. Besides, newsgroups have a number of
  21. readers who might know a better or an alternative answer. Don't be
  22. discouraged, though, if you get a reply like this from me. I am
  23. always glad to hear from fellow Turbo Pascal users.
  24.  
  25. ....................................................................
  26. Prof. Timo Salmi   Co-moderator of news:comp.archives.msdos.announce
  27. Moderating at ftp:// & http://garbo.uwasa.fi archives  193.166.120.5
  28. Department of Accounting and Business Finance  ; University of Vaasa
  29. ts@uwasa.fi http://uwasa.fi/~ts BBS 961-3170972; FIN-65101,  Finland
  30.  
  31. --------------------------------------------------------------------
  32. 26) How to get ansi control codes working in Turbo Pascal writes?
  33. 27) How to evaluate a function given as a string to the program?
  34. 28) How does one detect whether input (or output) is redirected?
  35. 29) How does one set the 43/50 line text mode?
  36. 30) How can I assign a value to an environment variable in TP?
  37. 31) How does one store, and then restore the original screen?
  38. 32) How can I convert a TPU unit of one TP version to another?
  39. 33) Which error is e.g. Runtime error 205, etc
  40. 34) Why can't I open read-only files? I get "File access denied".
  41. 35) How do I obtain high and low parts of a byte variable?
  42. 36) How can I set a hi-intensity color background in the text mode?
  43. 37) Where can I find a program to convert (Turbo) Pascal to C?
  44. 38) How can I read input without echoing to the screen?
  45. 39) How can I edit the readln input stream?
  46. 40) How can I write (brand) something into my executables?
  47. 41) What is wrong with my program? It hangs without a clear pattern?
  48. 42) How do I convert a decimal word into a hexadecimal string, etc?
  49. 43) How to determine the last drive?
  50. 44) How can I put a running clock into my Turbo Pascal program?
  51. 45) How to establish if a name refers to a directory or not?
  52. 46) How does one disable alt-ctrl-del?
  53. 47) How can I test whether a file exists?
  54. 48) What is the name of the current Turbo Pascal program?
  55. 49) How is the code for rebooting the PC written in Turbo Pascal?
  56. 50) How can I write inline code?
  57. --------------------------------------------------------------------
  58.  
  59. From ts@uwasa.fi Sun Apr 28 00:00:26 1996
  60. Subject: Using ansi codes in a TP program
  61.  
  62. 26. *****
  63.  Q: How to get ansi control codes working in Turbo Pascal writes?
  64.  
  65.  A: It is very simple, but one has to be aware of the pitfalls.
  66. Let's start from the assumption that ansi.sys or a corresponding
  67. driver has been loaded, and that you know ansi codes. If you don't,
  68. you'll find that information in the standard MS-DOS manual. To apply
  69. ansi codes you just include the ansi codes in your write statements.
  70. For example the following first clears the screen and then puts the
  71. text at location 10,10:
  72.    write (#27, '[2J');         (* the ascii code for ESC is 27 *)
  73.    write (#27, '[10;10HUsing ansi codes can be fun');
  74. If you want to test (as you should) whether ansi.sys or some some
  75. replacement driver has been loaded, you can use the ISANSIFN
  76. function from my ftp://garbo.uwasa.fi/pc/ts/tspa3470.zip.
  77. Now the catches. If you have a
  78.    uses Crt;
  79. statement in your program, direct screen writes will be used, and
  80. the ansi codes won't work. You have either to leave out the Crt
  81. unit, or include
  82.    assign (output, '');
  83.    rewrite (output);
  84.    :
  85.    close (output);
  86. Occasionally I have seen it suggested that one should just set
  87.    DirectVideo := false;
  88. This is a popular misconception. It won't produce the desired
  89. result. I'm not claiming to know the reason for this quirk of Turbo
  90. Pascal. Rather it is an observation I've made.
  91.  
  92. -From: Bengt Oehman d92bo@efd.lth.se with a later dicussion with Bob
  93. Peck bpeck@prairienet.org and help from Duncan Murdoch
  94. dmurdoch@mast.queensu.ca. The `DirectVideo:=False' statement only
  95. tells the Crt unit to use BIOS calls instead of using direct
  96. video-memory writes. A demo program to illustrate the screen writing
  97. modes follows:
  98.  
  99. Program ScreenWriteDemo;
  100. USES Crt;
  101. BEGIN
  102.   Writeln('This is written directly to the video memory');
  103.   DirectVideo:=False;
  104.   Writeln('This is written via BIOS interrupt calls (int 10h)');
  105.   Assign(Output,'');
  106.   Append(Output);
  107.   Writeln('This is written via DOS calls (int 21h)');
  108. END.
  109.  
  110. A note: The latter could be also written as
  111.   Writeln(Output, 'This is written via DOS calls (int 21h)');
  112. since the writeln default is the standard output.
  113. --------------------------------------------------------------------
  114.  
  115. From ts@uwasa.fi Sun Apr 28 00:00:27 1996
  116. Subject: Writing an expression parser
  117.  
  118. 27. *****
  119.  Q: How to evaluate a function given as a string to the program?
  120.  
  121.  A: To do this you have to have a routine for parsing and evaluating
  122. your expression. This is a complicated task requiring a clever use
  123. of recursion. You can find such code in Stephen O'Brien (1988),
  124. Turbo Pascal, The Complete Reference. Borland-Osborne/McGraw-Hill,
  125. Chapter 10. Another, simpler piece of code can be found in Michael
  126. Yester (1989), Using Turbo Pascal, Que, Chapter 5.
  127.    I've also written such a function evaluation program myself, and
  128. much of it is based on the ideas in O'Brien with my own corrections
  129. and enhancements. The resulting program is available as fn.exe
  130. function evaluator in the ftp://garbo.uwasa.fi/pc/ts/tsfunc13.zip
  131. package (or whatever version number is the latest). Note however,
  132. that the source code is not included, nor available.
  133.    Tips from Justin Lee (ossm1jl@rex.uokhsc.edu):
  134.  67666 Sep 22 1994 ftp://garbo.uwasa.fi/pc/turboobj/parstp30.zip
  135.  parstp30.zip Recursive expression TP7.0/BP/VB/C++ parser, R.Loewy
  136. An excellent parser is included with all the Turbo Pascal versions
  137. since TP4.0 as part of the MCALC or TCALC spreadsheet example
  138. program. See mcparse.pas or tcparse.pas.
  139. --------------------------------------------------------------------
  140.  
  141. From ts@uwasa.fi Sun Apr 28 00:00:28 1996
  142. Subject: Detecting redirection
  143.  
  144. 28. *****
  145.  Q: How does one detect whether input (or output) is redirected?
  146.  
  147.  A: As we know input to a program can come from a file, from the
  148. console, or from a pipe or redirection. Examples of the latter are
  149.      type text.dat | program
  150.      program < text.dat
  151. A Turbo Pascal program can be made to detect the redirections using
  152. Interrupt 21Hex, function 44Hex, subfunction 00Hex. See PC Magazine
  153. April 16, 1991, p. 374 for the code, and Duncan (1988), Advanced
  154. MS-DOS Programming, pp. 412-413 for more information. Alternatively,
  155. you can utilize the preprogrammed routines
  156.   PIPEDIFN Is the standard input from redirection
  157.   PIPEDNFN Is the standard output redirected to nul
  158.   PIPEDOFN Is the standard output redirected
  159. from my ftp://garbo.uwasa.fi/pc/ts/tspa3470.zip units.
  160. --------------------------------------------------------------------
  161.  
  162. From ts@uwasa.fi Sun Apr 28 00:00:29 1996
  163. Subject: Setting the 43/50 line text mode
  164.  
  165. 29. *****
  166.  Q: How does one set the 43/50 line text mode?
  167.  
  168.  A: Quite simple. Just apply TextMode (C80 + font8x8).  Requires a
  169. "uses Crt;". First, however, you should test that you have a at
  170. least an EGA video adapter. (See DetectGraph in your TP manual).
  171. Also see TSUTLE.NWS in ftp://garbo.uwasa.fi/pc/ts/tsutle22.zip (or
  172. whichever version number is the current) for the non-standard wide
  173. text modes like 132x43.
  174.   { An example }
  175.   uses Crt;
  176.   var InitialMode : integer;
  177.   begin
  178.     InitialMode := LastMode;
  179.     TextMode (CO80 + Font8x8);
  180.     TextColor (LightCyan);
  181.     writeln ('Test1');
  182.     readln;
  183.     {}
  184.     TextMode (CO40);
  185.     writeln ('Test2');
  186.     readln;
  187.     {}
  188.     TextMode (InitialMode);
  189.     TextColor (Yellow);
  190.     writeln ('Test3');
  191.     readln;
  192.   end.
  193. --------------------------------------------------------------------
  194.  
  195. From ts@uwasa.fi Sun Apr 28 00:00:30 1996
  196. Subject: Assigning environment variable values
  197.  
  198. 30. *****
  199.  Q: How can I assign a value to an environment variable in TP?
  200.  
  201.  A: For assigning a value to (a parent process's) environment value
  202. you have to access and manipulate the Program Segment Prefix and
  203. Memory Control Blocks. This is a rather complicated undertaking. A
  204. source code with an accompanying article by Trudy Neuhaus can be
  205. found in PC Magazine Volume 11 Number 1 pages 425-427.
  206.    The budding TP programmers should note that the elementary trick
  207. of Exec (GetEnv('comspec'), '/c set key=whatever') will achieve only
  208. a transient result for the duration of the exec shell. When you exit
  209. the shell after this endeavor, the environment will be as it was.
  210.    Here is about the why. When the above command is executed, MS-DOS
  211. makes a copy of the environment, and uses the copy. When the above
  212. shelling terminates, the copy of the environment is deleted, and the
  213. original is restored. Hence the above trick cannot be used to change
  214. the parent environment.
  215.    If you don't want to try to go through this rather complicated
  216. task yourself, the routines
  217.  "SETEVN   Set a parent environment variable (variable=value)"
  218.  "SETENVSH Set an environment variable for the duration of shelling"
  219. can be found in my TP TPU collection ftp://garbo.uwasa.fi/pc/ts/
  220. tspa34*.zip (* = 40,50,55,60,70). No source code is included, nor
  221. available for tspa34. However, there is a TPENV section within
  222. ftp://garbo.uwasa.fi/pc/turbopas/bonus507.zip. From zeta@tcscs.com
  223. Gregory Youngblood: For a source code see /pc/source/setenv.zoo at
  224. Garbo.
  225.    One further detail. Users sometimes ask how one can change the
  226. prompt or the path from within a Turbo Pascal program. This is in no
  227. way different from changing the value of any other environment
  228. variable. Both PATH and PROMPT are environment variables that can be
  229. set with the MS-DOS SET command in the fashion described in the
  230. above. This is not changed in any way by the fact that you can apply
  231. PROMPT and PATH also in an alternative format not requiring the SET
  232. command.
  233. --------------------------------------------------------------------
  234.  
  235. From ts@uwasa.fi Sun Apr 28 00:00:31 1996
  236. Subject: Saving the screen
  237.  
  238. 31. *****
  239.  Q: How does one store, and then restore the original screen?
  240.  
  241.  A: Here is a simple outline for storing and restoring a text mode
  242. screen in the standard 80 x 25 mode. Note that the code below is
  243. incomplete in a sense that it works for a color monitor only,
  244. because the monochrome screen address is $B000:$0000.
  245.    For storing and restoring the graphics screen see Ohlsen & Stoker
  246. (1989), Turbo Pascal Advanced Techniques, Que, pp 333-337.
  247.   uses Crt;
  248.   type ScreenType = array [1..4000] of byte;        (* 2 x 80 x 25 *)
  249.   var ColorScreen : ScreenType Absolute $B800:$0000;
  250.       SavedScreen : ScreenType;
  251.       posx, posy : byte;
  252.   begin
  253.     SavedScreen := ColorScreen;      (* Save the screen *)
  254.     posx := WhereX; posy := WhereY;  (* Save the cursor position *)
  255.     writeln ('A simple demo storing and restoring the color text screen');
  256.     writeln ('By Prof. Timo Salmi, ts@uwasa.fi');
  257.     writeln; write ('Press <-'''); readln;
  258.     ColorScreen := SavedScreen;   (* Restore the screen *)
  259.     GotoXY(posx,posy);            (* Go to the stored cursor position *)
  260.   end.
  261. If you would prefer not using the Crt unit, you can apply WHEREXFN,
  262. WHEREYFN, and GOATXY from TSUNTG.TPU from my units collection
  263. ftp://garbo.uwasa.fi/pc/ts/tspa3470.zip.
  264.    If you wish to test for the monitor type, that is choose between
  265. $B800:$0000 and $B000:$0000 bases, you can use the following
  266. function to test for the monochrome adapter.
  267.   function MONOFN : boolean;
  268.   var regs : registers;
  269.   begin
  270.     FillChar (regs, SizeOf(regs), 0);
  271.     regs.ah := $0F;
  272.     Intr ($10, regs);
  273.     monofn := (regs.al = 7);
  274.   end;  (* monofn *)
  275. --------------------------------------------------------------------
  276.  
  277. From ts@uwasa.fi Sun Apr 28 00:00:32 1996
  278. Subject: Converting TPUs
  279.  
  280. 32. *****
  281.  Q: How can I convert a TPU unit of one TP version to another?
  282.  
  283.  A: Forget it. In practical terms such a conversion is not on. The
  284. Turbo Pascal TPU units are strictly version dependent. If there were
  285. a working solution I assume we would have heard of it long since.
  286. The hacks that have been tried won't solve this dilemma. For all
  287. practical purposes you need the source code and the relevant
  288. compiler version.
  289.    You may nevertheless wish to ascertain for which version a TPU
  290. unit has been compiled. This is very simple. Just look at the first
  291. four character of a TPU file. The codes are
  292.  TPU0  for 4.0
  293.  TPU5  for 5.0
  294.  TPU6  for 5.5
  295.  TPU9  for 6.0
  296.  TPUQ  for 7.0 real mode
  297. But don't go editing these. It will not get you anywhere.
  298. --------------------------------------------------------------------
  299.  
  300. From ts@uwasa.fi Sun Apr 28 00:00:33 1996
  301. Subject: Finding about runtime errors
  302.  
  303. 33. *****
  304.  Q: Which error is e.g. Runtime error 205
  305.  
  306.  A: Basically this is a case of RTFM (read the f*ing manual). But it
  307. is very easy to find out even without resorting to the manual. Put
  308. temporarily the statement RunError (205); as the first statement of
  309. your program. Then run your program from the Turbo Pascal IDE, that
  310. is from within the TP editor. The description of the error will
  311. appear.
  312.    If you run a program from within a Turbo Pascal IDE, it is
  313. advisable to turn on the debug options on. You'll get both the error
  314. number and the description. Furthermore by pressing F1 after the
  315. error you get its description in a more verbal format.
  316.    One further trick is to put "uses TSERR"; (Include verbal
  317. run-time error messages) into your program. If you do that, the
  318. run-time errors will be given with a verbal description not just as
  319. a number. TSERR.TPU is part of my TPU collection at Garbo
  320. ftp://garbo.uwasa.fi/pc/ts/tspa3470.zip.
  321.    In TP 7.0 the run time errors can also be found by invoking
  322. "Help" from the main manu (Alt-H) and selecting "Error messages".
  323. --------------------------------------------------------------------
  324.  
  325. From ts@uwasa.fi Sun Apr 28 00:00:34 1996
  326. Subject: Opening read-only files
  327.  
  328. 34. *****
  329.  Q: Why can't I open read-only files? I get "File access denied".
  330.  
  331.  A: The answer is rather simple, but it is not well displayed in the
  332. manuals. In order to read a read-only file you have to set the
  333. FileMode as 0 like below. Else you'll get runtime error 005 "File
  334. access denied".
  335.   var f      : text;          (* Can be any file type *)
  336.       savefm : byte;
  337.   begin
  338.     savefm := FileMode;       (* Save the current FileMode status *)
  339.     FileMode := 0;            (* The default is 2 *)
  340.     assign (f, 'readonly.txt');
  341.     reset (f);
  342.     { have your wicked ways }
  343.     close (f);
  344.     FileMode := savefm;       (* Restore the original FileMode *)
  345.   end.
  346. --------------------------------------------------------------------
  347.  
  348. From ts@uwasa.fi Sun Apr 28 00:00:35 1996
  349. Subject: Getting a nybble from a byte
  350.  
  351. 35. *****
  352.  Q: I have a variable of type BYTE and would like to extract two
  353. numbers from it. (The first 4 bits making up number A, the second 4
  354. bits making up number B).  How can I extract these two numbers?
  355.  
  356.  A: Ah, this question brings back the good bad old days of the
  357. Commodore C64 programming when bit operations were rather a rule
  358. than an exception. Here is the solution.
  359.   function HIBYTEFN (x : byte) : byte;
  360.   begin
  361.     hibytefn := x Shr 4;           (* Shift right by four bits *)
  362.   end;
  363.   {}
  364.   function LOBYTEFN (x : byte) : byte;
  365.   begin
  366.     lobytefn := x and 15;          (* x and 00001111 *)
  367.   end;
  368. From Patrick Taylor (exuptr@exu.ericsson.se): Ah, leave it to Timo
  369. to come up with a different way! An other is (n div 16)
  370. (n mod 16).
  371.    Patrick is right.  But unless the compiler is optimized, the
  372. former produces more efficient code. Not that it really makes any
  373. practical difference whatsoever.
  374.    Of course the fastest code is produced using assembler as pointed
  375. out by Maarten Pennings (maarten@cs.ruu.nl) who provided the
  376. following inline example:
  377.   function high(b:byte):byte;
  378.     inline($58         { POP AX      | AH=?, AL=b       }
  379.           /$30/$e4     { XOR AH,AH   | AH=0, AL=b       }
  380.           /$b9/$04/$00 { MOV CX,0004 | AH=0, AL=b, CL=4 }
  381.           /$d3/$e8     { SHR AX,CL   | AX=b shr 4       }
  382.           );
  383.  
  384.  A2: Getting a word from a longint can alternatively be achieved
  385. without any calculations by using a kind of typecasting. Below is
  386. the code I have utilized in ftp://garbo.uwasa.fi/pc/ts/tspa3470.zip.
  387.   (* Get the high-order word of the longint argument *)
  388.   function HIWORDFN (x : longint) : word;
  389.   type type1 = record
  390.                  low  : word;
  391.                  high : word;
  392.                end;
  393.   var m1 : type1 absolute x;
  394.   begin
  395.     hiwordfn := m1.high;
  396.   end;  (* hiwordfn *)
  397. --------------------------------------------------------------------
  398.  
  399. From ts@uwasa.fi Sun Apr 28 00:00:36 1996
  400. Subject: Setting hi-intensity background
  401.  
  402. 36. *****
  403.  Q: How can I set a hi-intensity color background in the text mode?
  404.  
  405.  A: As you should know, the you can test for a blinking text for
  406. example as follows.
  407.   uses Crt;
  408.   begin
  409.     TextColor (11 + 128);  (* or LightCyan + Blink *)
  410.     TextBackground (Blue);
  411.     writeln ('What''s the catch?');  (* An aside, note the '' pair *)
  412.   end.
  413. In the above, bit 7 (the 128) controls the blinking. If you have at
  414. least an EGA, you can alter the interpretation of the highest text
  415. color bit to denote a hi-intensity background, but then you lose the
  416. the blinking. The following piece of code disables blinking,
  417. enabling a hi-intensity background.
  418.   uses Dos;
  419.   var regs : registers;
  420.   begin
  421.     FillChar (regs, SizeOf(regs), 0); (* An initialization precaution *)
  422.     regs.ah := $10;                   (* Function $10 *)
  423.     regs.al := $03;                   (* Subfunction $03 *)
  424.     regs.bl := $00;
  425.     Intr ($10, regs);      (* ROM BIOS video driver interrupt *)
  426.   end.
  427. To enable blinking again, set regs.bl := $01; Any high-intensity
  428. background you may have currently on the screen, will instantly
  429. change into a blinking text a a low-intensity background.
  430.  
  431.  A2: The previous answer assumes at least an EGA. Otherwise ports
  432. must be accessed. This is both advanced and dangerous programming,
  433. because errors in handling posts can do real harm. Besides it is
  434. fair to require at least an EGA in writing modern programs, at least
  435. for non-laptops, and on the latter the colors don't really matter
  436. for CGA and below. Let's take a look, nevertheless, how this is done
  437. for a CGA. Note that this won't work an an EGA and beyond, not at
  438. least in my tests. For detecting the video adapter you have, see the
  439. DetectGraph procedure in you Turbo Pascal manual.
  440.    First we need some basics from MEMORY.LST in Ralf Brown's
  441. ftp://garbo.uwasa.fi/pc/programming/inter49b.zip (or whatever
  442. version is current):
  443.  Format of BIOS Data Segment at segment 40h:
  444.   63h WORD Video CRT controller base address: color=03D4h, mono=03B4h
  445.   65h BYTE Video current setting of mode select register 03D8h/03B8h
  446. From David Jurgens's ftp://garbo.uwasa.fi/pc/programming/helppc21.zip
  447. we see
  448.   3D0-3DF Color Graphics Monitor Adapter (ports 3D0-3DB are
  449.           write only, see 6845)
  450.   3D8 6845 Mode control register (CGA, EGA, VGA, except PCjr)
  451. From Darryl Friesen's (friesend@jester.usask.ca) in the late
  452. comp.lang.pascal we have, the following procedure, with my own added
  453. comments (* *).
  454.   procedure SetBlinkState (state : boolean);
  455.   var ModeRegPort : word;
  456.       ModeReg     : byte;
  457.   begin
  458.     Inline($FA); { CLI }           (* Interrupts off *)
  459.     ModeRegPort := MemW[$0040:$0063]+4;  (* Typically $03D4+4 = $03D8 *)
  460.     ModeReg := Mem[$0040:$0065];   (* Typically 1001 *)
  461.     if state then                  (* Bit 5 controls blink enable *)
  462.       ModeReg := ModeReg or $20    (* $20 = 00100000 (base2) *)
  463.     else
  464.       ModeReg := ModeReg and $DF;  (* $DF = 11011111 disable *)
  465.     Port[ModeRegPort] := ModeReg;  (* Typically $9 = 00001001 *)
  466.     Mem[$0040:$0065] := ModeReg;   (*       or $29 = 00101001 *)
  467.     Inline($FB) { STI }            (* Interrupts on *)
  468.   end;
  469. --------------------------------------------------------------------
  470.  
  471. From ts@uwasa.fi Sun Apr 28 00:00:37 1996
  472. Subject: Pascal to C
  473.  
  474. 37. *****
  475.  Q: Where can I find a program to convert (Turbo) Pascal to C?
  476.  
  477.  A: This is a relevant question, but I have placed elsewhere the
  478. tips on the "looking for a program" questions. Here are the
  479. pointers to further pointers :-). (The FAQ versions might have been
  480. updated since I wrote this.)
  481.  ftp://garbo.uwasa.fi/pc/pd2/camfaq.zip
  482.  camfaq.zip comp.archives.msdos.(d/announce) FAQ (general finding)
  483.  :
  484.  ftp://garbo.uwasa.fi/pc/ts/tsfaqn44.zip
  485.  tsfaqn44.zip Questions from UseNet and Timo's answers
  486.  :
  487.  ftp://garbo.uwasa.fi/pc/pd2/faquote.zip
  488.  faquote.zip Old information from tsfaq Frequently Asked Questions
  489. --------------------------------------------------------------------
  490.  
  491. From ts@uwasa.fi Sun Apr 28 00:00:38 1996
  492. Subject: Turning off the input echo
  493.  
  494. 38. *****
  495.  Q: How can I read input without echoing to the screen?
  496.  
  497.  A: It is fairly simple. Study this example source code, with the
  498. manual, if need be.
  499.   uses Crt;
  500.   var password : string;
  501.   {}
  502.   (* Read without echoing *)
  503.   procedure GETPASS (var s : string);
  504.   var key : integer;
  505.       ch : char;
  506.   begin
  507.     s := '';
  508.     repeat
  509.       ch := ReadKey; key := ord (ch);
  510.       case key of
  511.          0 : ch := ReadKey;  (* Discard two-character keys, like F1 *)
  512.         13 : exit;           (* Enter has been pressed *)
  513.         1..12,13..31,255 :;  (* Discard the special characters *)
  514.         else s := s + ch;
  515.       end;
  516.    until false;
  517.   end;  (* getpass *)
  518.   {}
  519.   (* The main program *)
  520.   begin
  521.     write ('Password: ');
  522.     GETPASS (password);
  523.     writeln;
  524.     writeln (password);
  525.   end.
  526.   {}
  527. If you wish to be able to edit the input stream, like having the
  528. BackSpace functional, that is more complicated, and is left as an
  529. exercise after these basics. A hint: 8 : Delete (s, Length(s), 1);
  530.    There is another approach to this problem pointed out by Colin
  531. Lamond colin@sound.demon.co.uk. Quite innovative in its simplicity
  532. once one comes to think of it. "Set the textcolor, and the
  533. textbackground to the same color, and so the typed text can not be
  534. seen on the screen."
  535. --------------------------------------------------------------------
  536.  
  537. From ts@uwasa.fi Sun Apr 28 00:00:39 1996
  538. Subject: Input line-editing
  539.  
  540. 39. *****
  541.  Q: How can I edit the readln input stream?
  542.  
  543.  A: In practice, if you wish to use anything beyond simple the
  544. BackSpace deleting, you'll have to build your own line editing
  545. routines expanding on the code in the previous item. It is quite a
  546. task, and you can alternatively find the preprogrammed routines in
  547. my Turbo Pascal units ftp://garbo.uwasa.fi/pc/ts/tspa3470.zip (or
  548. whatever version number is current).
  549.  EDRDEBLN Editable Readln with ctrl-c, break trapping, pre-fill etc
  550.  EDRDEFLN Editable Readln with recall, pre-fill, and insert toggle
  551.  EDRDLN   Readln with line-editing potential (the simplest)
  552.  EDREABLN Edreadln with ctrl-c and break trapping
  553.  EDREADLN Editable Readln with recall, and insert toggle
  554. --------------------------------------------------------------------
  555.  
  556. From ts@uwasa.fi Sun Apr 28 00:00:40 1996
  557. Subject: Executable branding
  558.  
  559. 40. *****
  560.  Q: How can I write (brand) something into my executables?
  561.     Here is the actual question that led me to writing this item: 'I
  562.     am very interested in the .EXE "branding" techniques you use in
  563.     your TSUNTI unit. Would it be possible to get hold of the source
  564.     code for that unit, as it would save me from having to re-invent
  565.     the wheel?'
  566.  
  567.  A: What you are referring to is
  568.  BRANDEXE Store information within your program's .exe file (MS-DOS 3.0+)
  569.  CHKSUMFN Checksum self-test to detect any tampering (MS-DOS 3.0+)
  570.  USECOUNT Get the number of times the program has been used
  571. Sorry no, I don't want to distribute my source codes from
  572. ftp://garbo.uwasa.fi/pc/turbopas/ts/tspa3470.zip. Besides they would
  573. be less useful to you than you may think because internally my
  574. programs are in Finnish, comments, variable and procedure names, and
  575. all. But I can hopefully help you by giving a reference to a similar
  576. code.  Please see Ohlsen & Stoker, Turbo Pascal Advanced Techniques,
  577. Que, 1989, p. 420.
  578. --------------------------------------------------------------------
  579.  
  580. From ts@uwasa.fi Sun Apr 28 00:00:41 1996
  581. Subject: Elusive, inconsistent errors
  582.  
  583. 41. *****
  584.  Q: What is wrong with my program? It hangs without a clear pattern?
  585.  
  586.  A: With experience one learns that some programming errors are very
  587. elusive. I have many times seen users declaring that they have found
  588. a bug in Turbo Pascal, but in the overwhelming majority of cases it
  589. still is just a programming error, which just is more difficult to
  590. find than the more clear-cut cases. When you have symptoms like your
  591. program crashing from within the IDE, but working seemingly all
  592. right when called as stand-alone, or something equally strange, you
  593. might have one of the following problems.
  594. - A variable or some variables in your code are uninitialized thus
  595.   getting random values, which differ depending on your environment.
  596. - Your indexes are overflowing. Set on the range check {$R+}
  597.   directive for testing.
  598. - An error in the pointer logic.
  599. Normal debugging does not necessarily help in locating these errors
  600. because one is easily led to debugging the wrong parts of one's
  601. program. Especially the latter two reasons can cause errors which
  602. seemingly have nothing to do with the actual cause. This results
  603. from the fact that indexing and pointer errors can overwrite parts
  604. of memory causing strange quirks in your program. If you have used
  605. indexing with {$R-} or if you use pointer operations, sooner or
  606. later you are bound to have these problems in developing your
  607. applications.
  608.    See Edward Mitchell (1993), Borland Pascal Developer's Guide,
  609. 275-288 for common programming errors and especially the information
  610. on memory clobbering, in a useful chapter on debugging Turbo Pascal
  611. programs. You might also take a look at your Turbo Pascal User's
  612. Guide. At least version 7.0 has an instructive general
  613. categorization of errors on pages 76-77.
  614. --------------------------------------------------------------------
  615.  
  616. From ts@uwasa.fi Sun Apr 28 00:00:42 1996
  617. Subject: Converting the number base
  618.  
  619. 42. *****
  620.  Q: How do I convert a decimal word into a hexadecimal string, etc?
  621.  
  622.  A: Here is one possibility
  623.   function HEXFN (decimal : word) : string;
  624.   const hexDigit : array [0..15] of char = '0123456789ABCDEF';
  625.   begin
  626.     hexfn := hexDigit[(decimal shr 12)]
  627.           + hexDigit[(decimal shr 8) and $0F]
  628.           + hexDigit[(decimal shr 4) and $0F]
  629.           + hexDigit[(decimal and $0F)];
  630.   end;  (* hexfn *)
  631. Here is another conversion example (from longint to binary string)
  632.   function LBINFN (decimal : longint) : string;
  633.   const BinDigit : array [0..1] of char = '01';
  634.   var i     : byte;
  635.       binar : string;
  636.   begin
  637.     FillChar (binar, SizeOf(binar), ' ');
  638.     binar[0] := chr(32);
  639.     for i := 0 to 31 do
  640.       binar[32-i] := BinDigit[(decimal shr i) and 1];
  641.     lbinfn := binar;
  642.   end;  (* lbinfn *)
  643. For a full set of conversions, both from and to decimal, apply
  644. TSUTNTB.TPU from ftp://garbo.uwasa.fi/pc/ts/tspa3470.zip.
  645. --------------------------------------------------------------------
  646.  
  647. From ts@uwasa.fi Sun Apr 28 00:00:43 1996
  648. Subject: Identifying the last drive
  649.  
  650. 43. *****
  651.  Q: How to determine the last drive?
  652.  
  653.  A: One way of doing that is utilizing the information in DPB, that
  654. is the Drive Parameter Block, but that is rather complicated, so you
  655. can find that without source code in the TSUNTH unit in
  656. ftp://garbo.uwasa.fi/pc/ts/tspa3470.zip .
  657.  Another way is using interrupt 21H, function 36H to detect if a
  658. drive exists starting from the first drive letter. The code is given
  659. below. The disadvantage of this method is that it does not
  660. distinguish between real and substituted drives.
  661.   uses Dos;
  662.   function LASTDFN : char;  (* Detect last harddisk letter *)
  663.   var regs : registers;
  664.       i    : byte;
  665.   begin
  666.     i := 2;
  667.     repeat
  668.       Inc(i);
  669.       FillChar (regs, SizeOf(regs), 0);
  670.       regs.ah := $36;
  671.       regs.dl := i;
  672.       MsDos(regs);
  673.     until (regs.ax = $FFFF);
  674.     lastdfn := chr(i+63);
  675.   end;  (* lastdfn *)
  676. --------------------------------------------------------------------
  677.  
  678. From ts@uwasa.fi Sun Apr 28 00:00:44 1996
  679. Subject: Clock display in a TP program
  680.  
  681. 44. *****
  682.  Q: How can I put a running clock into my Turbo Pascal program?
  683.  
  684.  A: We are not speaking of a stand-alone TSR-clock (which is a
  685. different task), but considering a clock that continuously displays
  686. the time in some part of the output screen of your Turbo Pascal
  687. program.
  688.     You might first want to read the earlier items about ReadKey
  689. usages if you are not familiar with it (you probably are, because
  690. you would not pose this advanced question if you were a novice). The
  691. items are the unlikely "How do I disable or capture the break key in
  692. Turbo Pascal?" and "How can I read input without echoing to the
  693. screen?"
  694.    The general idea is to make the body of the program a repeat
  695. until loop using ReadKey for input and updating the clock display
  696. at suitable junctions within the loop. The scheme is thus something
  697. like the following.
  698.   procedure showtime;
  699.     begin
  700.       { if the second has changed, write the time }
  701.     end;
  702.   :
  703.   repeat
  704.     { do whatever }
  705.     showtime;
  706.     if KeyPressed then
  707.       case ReadKey of
  708.         { whatever }
  709.         { exit rules }
  710.       end;
  711.     showtime;
  712.     :
  713.     showtime;
  714.   until false;
  715.    One trick of the trade is that you must not update your clock
  716. each time the clock routine is encountered. You should test if the
  717. second has changed, and update only then. Else you are liable to get
  718. an annoying flicker in your clock.
  719. --------------------------------------------------------------------
  720.  
  721. From ts@uwasa.fi Sun Apr 28 00:00:45 1996
  722. Subject: Is a name a directory
  723.  
  724. 45. *****
  725.  Q: How to establish if a name refers to a directory or not?
  726.  
  727.  A: This question has turned out a bit more complicated than I first
  728. thought. There are several methods, each with some catch. The first
  729. is trying to open the name as a file and observing the IOResult. The
  730. ISDIRFN function in ftp://garbo.uwasa.fi/pc/ts/tspa3470.zip TPU unit
  731. TSUNTJ.TPU is based on this method. Unfortunately it is not always
  732. stable. I have been reported problems in connection with DRDOS by
  733. Richard Breuer (ricki@pool.informatik.rwth-aachen.de) who has
  734. tested these routines.
  735.   The second method (ISDIR2FN) is based on the fact that the file
  736. NUL exists in a directory if the directory exists.
  737.   The thrid method (ISDIR3FN) is a brute force method. It is given
  738. below, since it is quite an instructive little exercise of Turbo
  739. Pascal programming.
  740.   (* Search recursively through a drive's directories.
  741.      Auxiliary, recursive procedure for ISDIR3FN *)
  742.   procedure SEARCHDR (Path, FileSpec : string;
  743.                       name           : string;
  744.                       var found      : boolean);
  745.   var FileInfo : SearchRec;
  746.   begin
  747.     FindFirst (Path + '*.*', Directory, FileInfo);
  748.     while DosError = 0 do
  749.       begin
  750.         if ((FileInfo.Attr and Directory) > 0) and
  751.             (FileInfo.Name <> '.') and
  752.             (FileInfo.Name <> '..') then
  753.               begin
  754.                 SEARCHDR (Path + FileInfo.Name + '\',
  755.                           FileSpec,
  756.                           name,
  757.                           found);
  758.                 if Path + FileInfo.Name + '\' = name then
  759.                   found := true;
  760.               end;
  761.         FindNext (FileInfo);
  762.       end; {while}
  763.   end;  (* searchdr *)
  764.  
  765.   (* Does a name refer to a directory *)
  766.   function ISDIR3FN (name : string) : boolean;
  767.   var drive : char;
  768.       found : boolean;
  769.   begin
  770.     {... Default value ...}
  771.     isdir3fn := false;
  772.     {... Discard empty names ...}
  773.     if name = '' then exit;
  774.     {... Expand into a fully qualified name, makes it uppercase ...}
  775.     name := FExpand (name);
  776.     if name[Length(name)] <> '\' then name := name + '\';
  777.     {... Extract the drive letter from the name ...}
  778.     drive := UpCase (name[1]);
  779.     {... Check first for the root ...}
  780.     if drive + ':\' = name then
  781.       begin isdir3fn := true; exit; end;
  782.     {... Check the rest of the directories recursively ...}
  783.     found := false;
  784.     SEARCHDR (drive + ':\', '*.*', name, found);
  785.     isdir3fn := found;
  786.   end;  (* isdir3fn *)
  787.  
  788. -Date: Mon, 13 Jun 1994 00:13:05 +0000 (GMT)
  789. -From: JEROEN SCHIPPER <JSCHIPPER@HUT.NL>
  790. -To: ts@uwasa.fi (Timo Salmi)
  791. -Subject: Is a name a directory in TP
  792.  
  793. The method I use is simply checking the attribute bit, as this small
  794. program will demonstrate:
  795.   program isdir;
  796.   uses dos;
  797.   var s:string;
  798.       attr:word;
  799.       f:file;
  800.   begin
  801.     repeat
  802.       readln(s);
  803.       if s = '' then break;
  804.       assign(f,s);
  805.       getfattr(f,attr);
  806.       if doserror <> 0 then
  807.         writeln('DOS error code = ', doserror)
  808.       else
  809.       begin
  810.         if attr and directory <> 0 then
  811.           writeln(S,' is a directory')
  812.         else
  813.           writeln(S,' is a not directory')
  814.       end;
  815.     until false;
  816.   end.
  817. The methods you mention in your faq are far more complicated, but
  818. why? Is there are catch why the method above won't work? I guess
  819. don't really understand the problem here.
  820. Jeroen.
  821.  
  822.  A2: This has turned out to be a tricky FAQ. There are some
  823. additional suggestions and comments from the gentle readers. You can
  824. track them from ftp://garbo.uwasa.fi/pc/ts/tspost00.zip index.
  825. --------------------------------------------------------------------
  826.  
  827. From ts@uwasa.fi Sun Apr 28 00:00:46 1996
  828. Subject: Disabling alt-ctrl-del
  829.  
  830. 46. *****
  831.  Q: How does one disable alt-ctrl-del?
  832.  
  833.  A: I can only give a pointer to source code. Take a look at
  834.  4067 Jul 1 1993 ftp://garbo.uwasa.fi/pc/turbopa7/cadthf10.zip
  835.  cadthf10.zip CadThief TP6+ unit for trapping ctrl+alt+del, M.Hanninen
  836. and
  837.  30673 Oct 13 1987 ftp://garbo.uwasa.fi/pc/turbopas/keyint.zip
  838.  keyint.zip Disable alt-ctrl-del + other int09h TP tricks, N.Rubenking
  839. and
  840.  7105 Apr 19 1995 ftp://garbo.uwasa.fi/pc/turbopa7/cad_int9.zip
  841.  cad_int9.zip Disable Ctrl-Alt-Del via new TP kb interrupt, J.Robertson
  842. Also see Lou Duchez's source code in TSR.SWG examples in the fine
  843. SWAG (SourceWare Archival Group's) collection of TP sources.
  844. Available from the /pc/turbopas directory at Garbo. For the current
  845. references to the SWAG files see ftp://garbo.uwasa.fi/pc/INDEX.ZIP.
  846.    I have utilized alt-ctrl-del disabling at least in one of my own
  847. programs (PESTIKID.EXE). The code is not available, but the general
  848. idea is replacing the old keyboard interrupt ($09) with a handler of
  849. one's own. If the handler detects alt-ctrl-del, the keyboard is
  850. reset, else the handler is chained back to the original interrupt.
  851. The chaining requires a rather complicated inline procedure provided
  852. in TurboPower Software's kit. An additional complication is that the
  853. del keypress must be intercepted already at the relevant port $60,
  854. and the alt and ctrl status must be tested, so that the rebooting
  855. will not be invoked. Resetting the keyboard requires accessing the
  856. $20 and $61 ports.
  857. --------------------------------------------------------------------
  858.  
  859. From ts@uwasa.fi Sun Apr 28 00:00:47 1996
  860. Subject: Does a file exist
  861.  
  862. 47. *****
  863.  Q: How can I test whether a file exists?
  864.  
  865.  A: There are several alternatives. Here is the most common with
  866. example code. It recognizes also read-only, hidden and system files.
  867.   function FILEXIST (name : string) : boolean;
  868.   var fm : byte;
  869.       f  : file;
  870.       b  : boolean;
  871.   begin
  872.     fm := FileMode;
  873.     FileMode := 0;
  874.     assign (f, name);
  875.     {$I-} reset(f); {$I+}
  876.     b := IOResult = 0;
  877.     if b then close(f);
  878.     filexist := b;
  879.     FileMode := fm;
  880.   end;
  881.  
  882. A second alternative is
  883.   Uses Dos;
  884.   function FILEXIST (name : string) : boolean;
  885.   var f  : file;
  886.       a  : word;
  887.   begin
  888.     assign (f, name);
  889.     GetFAttr (f, a);
  890.     filexist := false;
  891.     if DosError = 0 then
  892.       if ((a and Directory) = 0) and ((a and VolumeId) = 0) then
  893.         filexist := true;
  894.   end;
  895.  
  896. A third alternative is
  897.   Uses Dos;
  898.   function FILEXIST (name : PathStr) : boolean;
  899.   begin
  900.     filexist := FSearch (name, '') <> '';
  901.   end;
  902.  
  903. A fourth alternative is the following. Be careful with this option,
  904. since it works a bit differently from the others. It accepts wild
  905. cards. Thus, for example FILEXIST('c:\autoexec.*') would be TRUE in
  906. this method, while FALSE in all the above.
  907.   Uses Dos;
  908.   function FILEXIST (name : string) : boolean;
  909.   var f : SearchRec;
  910.   begin
  911.     filexist := false;
  912.     FindFirst (name, AnyFile, f);
  913.     if DosError = 0 then
  914.       if (f.attr <> Directory) and (f.attr <> VolumeId) then
  915.         filexist := true;
  916.   end;
  917. A good variation from KDT@newton.national-physical-lab.co.uk of this
  918. theme, disallowing wildcards:
  919.   function file_exists (fname :string) :boolean;
  920.   var f :searchrec;
  921.   begin
  922.     findfirst (fname, anyfile - directory - volumeid, f);
  923.     file_exists := (doserror + pos('*',fname) + pos('?',fname) = 0);
  924.   end;
  925. --------------------------------------------------------------------
  926.  
  927. From ts@uwasa.fi Sun Apr 28 00:00:48 1996
  928. Subject: The current program name
  929.  
  930. 48. *****
  931.  Q: What is the name of the current Turbo Pascal program?
  932.  
  933.  A: The name of the currently executing Turbo Pascal program is in
  934. ParamStr(0).
  935.    This was introduced in TP version 5.0, and as far as I recall at
  936. least MS-DOS version 3.0 is required. For TP 4.0 you can use
  937. "ParamStr0 The name of the program" from TSUNT45 in
  938. ftp://garbo.uwasa.fi/pc/ts/tspa3440.zip (or whatever the version
  939. number is the latest).
  940.    It is advisable to put the value into a string variable at be
  941. beginning of the program before eny I/O takes place. Thus you might
  942. wish to use:
  943.   var progname : string;
  944.   begin  { the main program }
  945.     progname := ParamStr(0);
  946.     :
  947. A bonus of this method is that you can access the individual
  948. characters of progname (e.g. progname[1] for the drive) while that
  949. is not possible to do for the ParamStr keyword.
  950. --------------------------------------------------------------------
  951.  
  952. From ts@uwasa.fi Sun Apr 28 00:00:49 1996
  953. Subject: How can a program reboot my PC?
  954.  
  955. 49. *****
  956.  Q: How is the code for rebooting the PC written in Turbo Pascal?
  957.  
  958.  A: This item draws from the information and the C-code example in
  959. Stan Brown's, later J.Carlyle's comp.os.msdos.programmer FAQ,
  960. ftp://garbo.uwasa.fi/pc/doc-net/dosfv206.zip (at the time of
  961. updating this), from memory.lst and interrup.b in
  962. ftp://garbo.uwasa.fi/pc/programming/inter49b.zip, and from
  963. ftp://garbo.uwasa.fi/pc/programming/helppc21.zip. The Turbo Pascal
  964. code is my adaptation of the C-code. It is not a one-to-one port.
  965.    The usually advocated warm-boot method is storing $1234 in the
  966. word at $0040:$0072 and jumping to address $FFFF:$0000. The problem
  967. with this approach is that files must first be closed, potential
  968. caches flushed. This is how to do this
  969.   procedure REBOOT;
  970.   label next;
  971.   var regs  : registers;
  972.       i     : byte;
  973.       ticks : longint;
  974.   begin
  975.     {... "press" alt-ctrl ...}
  976.     mem[$0040:$0017] := mem[$0040:$0017] or $0C;  { 00001100 }
  977.     {... "press" del, try a few times ...}
  978.     for i := 1 to 10 do
  979.       begin
  980.         FillChar (regs, sizeOf(regs), 0);  { initialize }
  981.         regs.ah := $4F;  { service number }
  982.         regs.al := $53;  { del key's scan code }
  983.         regs.flags := FCarry;  { "sentinel for ignoring key" }
  984.         Intr ($15, regs);
  985.         {... check if the del key registered, if not retry ...}
  986.         if regs.flags and Fcarry > 0 then goto next;
  987.         {... waste some time, watch out for midnight ...}
  988.         ticks := MemL [$0040:$006C];
  989.         repeat until (MemL[$0040:$006C] - ticks > 3) or
  990.                      (MemL[$0040:$006C] - ticks < 0)
  991.     end; {for}
  992.     exit;
  993.   next:
  994.     {... disk reset: writes all modified disk buffers to disk ...}
  995.     FillChar (regs, sizeOf(regs), 0);
  996.     regs.ah := $0D;
  997.     MsDos (regs);
  998.     {... set post-reset flag, use $0000 instead of $1234 for coldboot ...}
  999.     memW[$0040:$0072] := $1234;
  1000.     {... jump to $FFFF:0000 BIOS reset ...}
  1001.     Inline($EA/$00/$00/$FF/$FF);
  1002.   end;  (* reboot *)
  1003. One slight problem with this approach is that the keyboard intercept
  1004. interrupt $15 service $4F requires at least an AT according to
  1005. ftp://garbo.uwasa.fi/pc/programming/inter49b.zip. A simple test
  1006. based on "FFFF:E byte ROM machine id" (the previous definition is
  1007. from ftp://garbo.uwasa.fi/pc/programming/helppc21.zip) is:
  1008.   function ISATFN : boolean;
  1009.   begin
  1010.      case Mem[$F000:$FFFE] of
  1011.        $FC, $FA, $F8 : isatfn := true;
  1012.        else isatfn := false;
  1013.      end; {case}
  1014.   end;  (* isatfn *)
  1015. For a more comprehensive test use CPUFN "Get the type of the
  1016. processor chip" from TSUNTH in ftp://garbo.uwasa.fi/pc/ts/tspa3470.zip
  1017. or see the TP + ASM code in Michael Ticher (1992), PC Intern System
  1018. Programming, pp. 725-727.
  1019.  
  1020.    An addition by Per Bergland (d6caps@dtek.chalmers.se): I recently
  1021. downloaded the FAQ for this newsgroup, and studied the code for
  1022. rebooting a PC. The problem with that code (calling FFFF:0000) is
  1023. that it will not work in protected mode programs such as those
  1024. compiled for Windows or BP7 DPMI, or even in a DOS program run in a
  1025. Windows DOS session. The solution provided has been tested on
  1026. various COMPAQ PC:s, but I think it will work on any AT-class
  1027. machine. It involves using the 8042 keyboard controller chip output
  1028. pin 0, which is physically connected to the reset pin of the CPU.
  1029. There is unfortunately no way to perform a "warm" reboot this way,
  1030. and the warnings about disk caches etc apply to this code, too (see
  1031. FAQ). The code is written in BP7 assembly lingo, because that's what
  1032. I normally write code in, but anyone could rewrite it in C or high
  1033. level Pascal.
  1034.   UNIT Reboot;
  1035.   INTERFACE
  1036.     procedure DoReboot;
  1037.   IMPLEMENTATION
  1038.     procedure DoReboot;assembler;
  1039.     asm
  1040.       cli
  1041.   @@WaitOutReady:       { Busy-wait until 8042 is ready for new command}
  1042.       in al,64h         { read 8042 status byte}
  1043.       test al,00000010b { Bit 1 of status indicates input buffer full }
  1044.       jnz @@WaitOutReady
  1045.       mov al,0FEh       { Pulse "reset" = 8042 pin 0 }
  1046.       out 64h,al
  1047.       { The PC will reboot now }
  1048.     end;
  1049.   END.
  1050. --------------------------------------------------------------------
  1051.  
  1052. From ts@uwasa.fi Sun Apr 28 00:00:50 1996
  1053. Subject: Writing inline code
  1054.  
  1055. 50. *****
  1056.  Q: How can I write inline code?
  1057.  
  1058.  A: In Turbo Pascal versions prior 6.0 assembler code could not be
  1059. directly included in the code. Instead one had to assemble the code
  1060. into inline statements. Consider the task of rebooting the PC
  1061. (without disk closing and cache flushing).  The assembler code for
  1062. this is
  1063.   mov ax,$40
  1064.   mov ds,ax
  1065.   mov wo [$72],$1234
  1066.   jmp $FFFF:$0000
  1067. To assemble this code into an inline statement write the following
  1068. file calling it e.g. debug.in.  The empty line is important. Also
  1069. carefully note that debug assumes hexadecimal notation. Do not use
  1070. the $ designator in debug.in.
  1071.   .... begin debug.in, cut here ....
  1072.   a 100
  1073.   mov ax,40
  1074.   mov ds,ax
  1075.   mov wo [72],1234
  1076.   jmp FFFF:0000
  1077.  
  1078.   u 100
  1079.   q
  1080.   .... end debug.in, cut here ....
  1081. Give the following command
  1082.   debug < debug.in
  1083. You'll get
  1084.   0E9E:0100 B84000        MOV     AX,0040
  1085.   0E9E:0103 8ED8          MOV     DS,AX
  1086.   0E9E:0105 C70672003412  MOV     WORD PTR [0072],1234
  1087.   0E9E:010B EA0000FFFF    JMP     FFFF:0000
  1088. This translates into
  1089.     Inline ($B8/$40/$00/
  1090.             $8E/$D8/
  1091.             $C7/$06/$72/$00/$34/$12/
  1092.             $EA/$00/$00/$FF/$FF);
  1093.  
  1094.  A2: You can also utilize an inline <--> asm converter called
  1095.   ftp://garbo.uwasa.fi/pub/pc/turbopas/inlin219.zip
  1096.   inlin219.zip Inline assembler for Turbo Pascal, w/src, D.Baldwin
  1097. It has two sources, inline.pas and uninline.pas which you can
  1098. compile to do the conversions in both directions for you. For
  1099. example, if you have a file test.asm containing the
  1100.   mov ax,$0040
  1101.   mov ds,ax
  1102.   mov word ptr [$72],$1234
  1103.   jmp far $FFFF:$0000
  1104. then "inline test.asm" will produce test.obj with the following,
  1105. expected contents
  1106.   Inline(
  1107.     $B8/$40/$00/           {mov ax,$0040}
  1108.     $8E/$D8/               {mov ds,ax}
  1109.     $C7/$06/$72/$00/$34/$12/ {mov word ptr [$72],$1234}
  1110.     $EA/$00/$00/$FF/$FF);  {jmp far $FFFF:$0000}
  1111. --------------------------------------------------------------------
  1112.  
  1113.